BulkUpdate Property, SftTree Object


	SftTree.BulkUpdate Property	Softel vdm, Inc.

Defines bulk update mode.

Syntax

Get
	VB.NET	Boolean = object.BulkUpdate As Boolean
	VB	Boolean = object.BulkUpdate As Boolean
	C#.NET	bool Boolean = object.BulkUpdate;
	VC++	VARIANT_BOOL Boolean = object->BulkUpdate; VARIANT_BOOL Boolean = object->GetBulkUpdate();
	C	HRESULT object->get_BulkUpdate(VARIANT_BOOL* Boolean);
	Delphi	Boolean := object.BulkUpdate : WordBool;
Put
	VB.NET	object.BulkUpdate = Boolean As Boolean
	VB	object.BulkUpdate = Boolean As Boolean
	C#.NET	bool object.BulkUpdate = Boolean;
	VC++	VARIANT_BOOL object->BulkUpdate = Boolean; void object->PutBulkUpdate(VARIANT_BOOL Boolean);
	C	HRESULT object->put_BulkUpdate(VARIANT_BOOL Boolean);
	Delphi	object.BulkUpdate := Boolean : WordBool;

object

A SftTree object.

Boolean

Defines bulk update mode.

Boolean	Description
True	A mass-update is in progress.
False	A mass-update is not in progress.

Comments

The BulkUpdate property defines bulk update mode.

The BulkUpdate property should be used when many items are added to a tree control or other lengthy operations are performed. By setting the property to True, the tree control can skip certain internal processing. Once updates are completed, the property has to be set to False. When adding, inserting or deleting items and when changing the Item.Level property, the tree control may have to do an extensive scan of parent items to determine if the current (visual) presentation has to be changed. This processing can be skipped when the BulkUpdate property is set to True, considerably speeding up the process.

After updating the tree control, the BulkUpdate property must be set to False. If the property remains set to True, the tree control will no longer redraw itself properly.

The BulkUpdate property is automatically reset to False whenever the control's Refresh method is used and when the Font, Headers.Font or RowHeaders.Font properties are changed.

This property is not available at design-time.